package com.ruoyi.circle.service;

import java.util.List;
import java.util.Map;

import com.ruoyi.circle.domain.CircleBasicInfo;
import com.ruoyi.circle.domain.CircleTagsRel;

/**
 * 圈子基础信息Service接口
 *
 * @author 区嘉盛
 * @date 2025-06-09
 */
public interface ICircleBasicInfoService {
    /**
     * 查询圈子基础信息
     *
     * @param id 圈子基础信息主键
     * @return 圈子基础信息
     */
    public CircleBasicInfo selectCircleBasicInfoById(Long id);

    /**
     * 查询圈子基础信息列表
     *
     * @param circleBasicInfo 圈子基础信息
     * @return 圈子基础信息集合
     */
    public List<CircleBasicInfo> selectCircleBasicInfoList(CircleBasicInfo circleBasicInfo);

    /**
     * 新增圈子基础信息
     *
     * @param circleBasicInfo 圈子基础信息
     * @return 结果
     */
    public int insertCircleBasicInfo(CircleBasicInfo circleBasicInfo);

    /**
     * 修改圈子基础信息
     *
     * @param circleBasicInfo 圈子基础信息
     * @return 结果
     */
    public int updateCircleBasicInfo(CircleBasicInfo circleBasicInfo);

    /**
     * 批量删除圈子基础信息
     *
     * @param ids 需要删除的圈子基础信息主键集合
     * @return 结果
     */
    public int deleteCircleBasicInfoByIds(Long[] ids);

    /**
     * 删除圈子基础信息信息
     *
     * @param id 圈子基础信息主键
     * @return 结果
     */
    public int deleteCircleBasicInfoById(Long id);

    /**
     * 检查并删除没有标签关联的圈子
     *
     * @param circleId 圈子ID
     */
    public void checkAndDeleteCircleWithoutTags(Long circleId);

    /**
     * 普通用户申请新建圈子
     *
     * @param circleBasicInfo 圈子基础信息
     * @return 结果
     */
    public int applyCircle(CircleBasicInfo circleBasicInfo);

    /**
     * 管理员审批圈子申请
     *
     * @param id       圈子ID
     * @param status   审批状态 1-已通过 2-已拒绝
     * @param approver 审批人
     * @return 结果
     */
    public int approveCircle(Long id, Long status, String approver);

    /**
     * 获取热门圈子列表
     *
     * @return 热门圈子列表
     */
    public List<CircleBasicInfo> getHotCircle();

    /**
     * 根据用户选择的标签将用户加入到相应的圈子中
     *
     * @param userId 用户ID
     * @param tagIds 标签ID数组
     */
    public void addUserToCirclesByTags(Long userId, Long[] tagIds);

    /**
     * 新增圈子标签关联
     *
     * @param circleTagsRel 圈子标签关联信息
     * @return 结果
     */
    public int insertCircleTagsRel(CircleTagsRel circleTagsRel);

    /**
     * 获取我创建的圈子列表
     *
     * @param createUserId 创建用户ID
     * @return 我创建的圈子列表
     */
    public List<CircleBasicInfo> getCircleCreatedByMe(Long createUserId);

    /**
     * 获取我加入的圈子列表
     *
     * @param userId 用户ID
     * @return 我加入的圈子列表
     */
    public List<CircleBasicInfo> getJoinedCircle(Long userId);

    /**
     * 获取我待审批的圈子列表
     *
     * @param createUserId 创建用户ID
     * @return 待审批的圈子列表
     */
    public List<CircleBasicInfo> getMyApprovalCircle(Long createUserId);

    /**
     * 批量新增圈子标签关联
     *
     * @param circleTagsRelList 圈子标签关联列表
     * @return 结果
     */
    public int insertBatchCircleTagsRel(List<CircleTagsRel> circleTagsRelList);

    /**
     * 获取圈子最新的热搜推送内容与题目推送内容
     *
     * @param circleId 圈子ID
     * @return 热搜推送内容，包含摘要和文章，与题目推送内容
     */
    public Map<String, Object> getLatestCircleHotSearchContent(Long circleId);

    /**
     * 获取所有圈子列表
     *
     * @return 所有圈子列表
     */
    public List<CircleBasicInfo> getAllCircle();

    /**
     * 获取圈子全部的热搜推送内容与题目推送内容
     *
     * @param circleId 圈子ID
     * @return 热搜推送内容，包含摘要和文章，与题目推送内容
     */
    public Map<String, Object> getAllCircleHotSearchContent(Long circleId);

    /**
     * 根据圈子名称查询圈子
     *
     * @param circleName 圈子名称
     * @return 圈子列表
     */
    public List<CircleBasicInfo> queryCircleByCircleName(String circleName);

    List<CircleBasicInfo> getCircleByTagId(Long tagId);
}
